home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / BBS_UTL / DDPLUS71 / ANSIMENU.ZIP / ANSIMENU.DOC next >
Text File  |  1995-03-14  |  4KB  |  88 lines
  1.                           ANSI MENU ROUTINES UNIT
  2.                               Copyright 1995
  3.                       By Scott M. Baker and Bob Dalton
  4.  
  5.                                INTRODUCTION:
  6.                                ------------
  7.           Sometimes you are going to want an ANSI menu of sometype
  8.           for your door program.  This unit adds that function to
  9.           the DDPlus package.  The ANSIMENU.PAS code included in
  10.           this archive is FREEWARE and can be used in any manner you
  11.           want and without cost, but remains copyrighted to Scott Baker.
  12.           The news.exe program, news.pas and supporting files remains
  13.           copyrighted to Scott Baker.  The ANSI Menu routines portion
  14.           of this document remain copyrighted to Scott Baker. Everything
  15.           else is copyrighted by Bob Dalton. 
  16.  
  17.                                 REQUIREMENTS:
  18.                                 ------------
  19.           At this point in time the only requirements are that you must
  20.           be using Borland Turbo Pascal version 6.0 or 7.0.  I compiled
  21.           the program with Borland Pascal 7.0 Professional and know it
  22.           works. I expect it will with TP 6.0 as well but can't guarantee
  23.           it.  You must also have already compiled the main DDPLUS.PAS
  24.           unit BEFORE compiling the NEWS.PAS.
  25.  
  26.                                 Files Included
  27.                                 --------------
  28.           Below is a listing of all files for the ANSIMENU.ZIP Package:
  29.  
  30.           NEWS.CTL    - Required Configuration file for the NEWS.EXE Program
  31.           NEWS.DIR    - Required file for the NEWS.EXE Program.
  32.           ANSIMENU.DOC- The text file you are reading.
  33.           NEWS.EXE    - Compiled version of the News.pas program. So you
  34.                          see it in action immediately.
  35.           ANSIMENU.PAS- The ansi menu unit.
  36.           NEWS.PAS    - The News program by Scott Baker.
  37.  
  38.                     Installation and Preparation for Use
  39.                     ------------------------------------
  40.  
  41.          1. Move the archive package to a temporary directory and "unzip".
  42.  
  43.          2. Before compiling the NEWS.pas be sure that your compiler knows
  44.          where to find the listed units.
  45.  
  46.          3.  Try the news.exe program first to see the end product BEFORE
  47.          looking at the code in the provided units. It will give you a better
  48.          feel for what is going on.
  49.  
  50.          4.  That's it!  Enjoy and good luck.
  51.  
  52.                           THE ANSI MENU ROUTINES
  53.                        ------------------------------
  54.  
  55.           There is an additional TPU file included with the
  56.           DDPLUS package that includes a user-friendly ANSI-MENU
  57.           handler. The TPU can be called up with the statement "USES
  58.           ANSIMENU". The menu system is accessed by the single
  59.           function:
  60.  
  61.                    CHAR:=GetAnsiMenu(menu_definition_template)
  62.  
  63.                 The menu-definition-template type is declared within
  64.           the unit. It is identical to the structure below:
  65.  
  66.  
  67.                  menutype = record
  68.                              header: string[80];
  69.                              footer: string[80];
  70.                              headercolor,
  71.                              footercolor,
  72.                              optioncolor,
  73.                              desccolor,
  74.                              arrowcolor,
  75.                              bracketcolor: byte;
  76.                              numoptions: byte;
  77.                              options: array[1..20] of string[1];
  78.                              desc: array[1..20] of string[80];
  79.                             end;
  80.  
  81.                 The structure is usually defined by your program as
  82.           a constant. The ANSIMENU procedure interprets this
  83.           strucure and uses it to generate a centered menu. The menu
  84.           options may be selected by using the numeric keypad (the 8
  85.           for up and the 2 for down) or by simply typing the the
  86.           letter of the option. A sample door, NEWS.PAS, is included
  87.           to demonstrate the use of the ansimenu unit.
  88.